home *** CD-ROM | disk | FTP | other *** search
/ HPAVC / HPAVC CD-ROM.iso / AXREAD12.ZIP / EXTERNAL.DOC < prev    next >
Text File  |  1996-08-03  |  7KB  |  162 lines
  1. External Message Editor Configuration Explaination
  2. ══─────────────────────────────────────────────∙·.
  3.  
  4.   Eventually, I would like to write my own Full Screen ANSi editor, however,
  5.   time is of the essence... errr, something like that! :) In any case, that's
  6.   a future version of READ.PPE! <g> For now, I'm gonna support some commom FS
  7.   editors!
  8.  
  9.  
  10. Full screen editors supported in this version of READ.PPE
  11. ══─────────∙·┬·∙─────────────────────────────────────────────────────────────══
  12. IceEdit      │ Tested with version 1.70, 1.75 & 2.00
  13. GEdit        │ (Not Tested Yet, hopefully added in next release)
  14. WWIVEdit     │ (Thinking about it, might insult a WWIV guru tho)
  15. ══─────────∙·┴·∙─────────────────────────────────────────────────────────────══
  16.  
  17.  
  18. Overview of using EXTx.BAT
  19. ══─────────────────────∙·.
  20.   If a file named EXT<NodeNum>.BAT exists in READ.PPE's current directory, it
  21.   tell's READ.PPE you are using an EXTERNAL MESSAGE EDITOR! Something NOT
  22.   supported by PCBoard itself. The way it works:
  23.  
  24.   1. If EXTx.BAT exists, READ.PPE uses it to call the editor. If it does not
  25.      exist, READ.PPE uses PCBoard's own editor as normal. The only problem
  26.      using PCB's internal editor is there's no way to call the editor and then
  27.      regain control with the PPE. So, CALLED.PPE is used to RELOAD READ.PPE
  28.      which eats memory. After replying to about 15 messages, 115k memory will
  29.      be allmost gone! Besides that, PCB's internal editor is completely hard
  30.      coded. It's ugly, and un-changeable.
  31.  
  32.   2. A parameter is passed to EXTx.BAT, and that is PPL's TempPath() var. This
  33.      is the directory MSGTMP, MSGINF, and DORINFO1.DEF are located for the
  34.      editor's use.
  35.  
  36.  
  37. Advantages of using an external editor
  38. ══─────────────────────────────────∙·.
  39.   Configurablity to the max! Dependant upon the editor you choose to use, you
  40.   can have options never before dreamed of with PCBoard!
  41.  
  42.   READ.PPE regains control *WITHOUT* loading again! So, this will save memory
  43.   and should solve all memory problems involved with READ.PPE! That is if the
  44.   message editor you use isn't a memory hog! <g>
  45.  
  46.   When quoteing a message, line 1 of read.cfg will be used as the quote char!
  47.   Meaning, if you put ├, then in the full screen editor, all the quoted text
  48.   would look like:
  49.  
  50.   ├People say this ppe rulez! :)
  51.  
  52.   Then, when reading the message (with read.ppe), "├" will be replaced with
  53.   line 2 as normal.
  54.  
  55.   When quoteing, you can configure what will be before and after the quoted
  56.   text (ie. 'John Doe said to Jane Doe...', 'Jane Doe repiles...', See
  57.   quote.doc for more informations)
  58.  
  59. Disadvantages of using an external editor
  60. ══────────────────────────────────────∙·.
  61.   Dependant upon the editor used, you may have to use a FOSSIL driver if you
  62.   do not allready.
  63.  
  64.  
  65. Configuring IceEdit to work with READ/ENTER.PPE
  66. ══──────────────────────────────────────────∙·.
  67.   I have tested READ/ENTER.PPE with IceEdit 1.70, 1.75 and 2.00. They seem to
  68.   be compatable withall three versions. Other versions may cause unpredictable
  69.   results. Use caution and common sence! (Note: See ICEEDIT.BAT for example)
  70.  
  71.   Required settings are:
  72.  
  73.   EDITCFG.EXE/Toggles
  74.  
  75.    [Toggle Menu 1]
  76.   * Use Soft C/Rs   NO
  77.  
  78.    [Toggle Menu 2]
  79.   * Quote Format    YES
  80.   * QBBS Compatible NO
  81.   * Errorlevels     YES
  82.  
  83.   EDITCFG.EXE/Other
  84.  
  85.   * SysOP Security  110 (Or whatever you have set as your Sysop Sec Level)
  86.   * Dropfile Type   DORINFO1.DEF
  87.  
  88.  
  89.   Now, you need to create the batch file to run IceEdit. Let's start with node
  90.   one. (EXT1.BAT)
  91.  
  92.   In a text editor, create EXT1.BAT in READ.PPE's main directory. It should
  93.   look like this:
  94.  
  95.   ══──[EXT1.BAT-Begin]────────────────────────────────────────────────────∙·.
  96. @echo off
  97. rem EXTx.BAT - used by READ.PPE to run an external message editor with PCBoard
  98. rem
  99. rem %1 = Work Dirctory, where MSGINF, MSGTMP & DORINFO1.DEF are located
  100. rem
  101. rem ** Setup for IceEdit ** (Tested with versions 1.70, 1.75 & 2.00)
  102. rem
  103. SET IEDIT=C:\PCB\ICEEDIT\                       ;Your path to IceEdit.EXE
  104. C:\PCB\ICEEDIT\ICEEDIT.EXE /D:%1 /N:%PCBNODE%   ;Run IceEdit with params *
  105. IF ERRORLEVEL 1 GOTO MSGERROR                   ;Handle an aborted message
  106. GOTO DONE
  107.  
  108. :MSGERROR
  109. Echo Message Aborted>%1MSGABT                   ;Creates MSGABT for READ.PPE **
  110.  
  111. :DONE
  112. SET IEDIT=                                      ;Clean up the enviroment :)
  113.   ══──[EXT1.BAT-End]──────────────────────────────────────────────────────∙·.
  114.  
  115.   * The /D: parameter tells IceEdit where to find MSGINF, MSGTMP and
  116.     DORINFO1.DEF. This is VERY important!
  117.  
  118.   ** A file named MSGABT in the temp directory is needed to tell READ.PPE
  119.      the message was aborted. It need not contain any valueable informations,
  120.      just exist.
  121.  
  122.  
  123. Configuring another editor to work with READ/ENTER.PPE
  124. ══─────────────────────────────────────────────────∙·.
  125.   At this time no other external editor has been tested, however, if it reads
  126.   MSGTMP, MSGINF and DORINFO1.DEF it *should* work. If your dareing, try it,
  127.   if not, send me the editor and I will! :)
  128.  
  129.  
  130. Notes about DORINFO1.DEF! (Read this!)
  131. ══─────────────────────────────────∙·.
  132.   PCBoard does not support external full screen editors, nor is PCB's default
  133.   message editor configurable! So, the need for an external editor is great!
  134.   Unfortunatly, PPL doesn't have a way to write a DOOR.SYS file (that I know
  135.   of), and sence DORINFO1.DEF is less complex, I decided to support it
  136.   instead.
  137.  
  138.   Now, to gather all the com port info for DORINFO1.DEF, READ.PPE reads it out
  139.   of the current node's PCBOARD.DAT file. If you use one PCBOARD.DAT file for
  140.   multiple nodes, the external editor will not address the correct comport!
  141.   Don't use an external editor! :) In a future version of READ.PPE I plan on
  142.   checking the /PCB eviroment to make sure your not using a different com port,
  143.   until then, deal with the memory problems and the non-configurable full
  144.   screen message editor... While your at it, bug the hell out of CDC and tell
  145.   them you want a configurable message header, full screen editor, and
  146.   configurable message quoter!
  147.  
  148.  
  149. Reach out and touch someone?!
  150. ══────────────────────────∙·.
  151.   NOTE: If you have/know of a full screen editor you want to see supported,
  152.   tell me and I'll see what I can do.
  153.  
  154.   Any questions? φ Need help? φ Suggestions? φ Comments? φ Contact me!
  155.  
  156.   E-mail: maverick@phcc.org
  157.   Salt Air: Kenneth Padgett
  158.   Sysop of: The No-Name BBS (703) 323-6838
  159.   FTP: x136.pcboard.com /pub/bbs/antix
  160.   WWW: http://pages.prodigy.com/no-name/anti-x.htm
  161.        http://pages.prodigy.com/no-name/kenneth.htm
  162.